Novell Help Librarian Data File Version 1.00 COPYRIGHT (c) 1985 by Novell, Inc. All Rights Reserved. Use the arrow keys to highlight an option, then press the SELECT key. Press ESCAPE to save selections and continue. Highlight a list entry, then press the SELECT key. Highlight a resource, then press the SELECT key. SELECT (Enter) Edit highlighted item. INSERT (Ins) Add new item. DELETE (Del) Delete marked item(s). MODIFY (F3) Change item name. MARK (F5) Mark highlighted item. UNMARK (F7) Unmark all items. Press ESCAPE to save changes and return to the preceding screen. Enter a name for the resource set, then press the SELECT key. INSERT (Ins) Add new item. MARK (F5) Mark highlighted item. DELETE (Del) Delete Marked item(s). UNMARK (F7) Unmark all items. Press ESCAPE to save changes and return to the preceding screen. Highlight the resource you want to add to the set, then press the SELECT key. Enter a name for the resource, then press the SELECT key. Enter a name for the configuration, then press the SELECT key. 1. Press the F2 key to switch between hex and decimal editing modes. 2. Highlight a field using the arrow keys, then press the SELECT key. 3. Edit the field using the arrow, DELETE, BACKSPACE, and SELECT keys. 4. Press ESCAPE to save configuration information. Highlight a configuration, then press the SELECT key. Use the arrow keys to scroll the display. Press ESCAPE to leave this window and continue. Use the arrow keys to highlight an option, then press the SELECT key. Select "Yes" to abandon the shell generation process and exit. Select "No" to return to the shell configuration menu. You must at least select and configure a LAN driver to generate a valid shell. Select "Yes" to save selected configurations and continue the shell generation process. Select "No" to abandon the shell generation process. Press ESCAPE to return to the shell configuration menu. EXIT SHCONFIG HELP Highlight "Yes" and press the SELECT key to exit the shell generation process and throw away all selections. Press the ESCAPE key, or highlight "No" and press the SELECT key to return to the shell generation process. Page 1 of 1B AVAILABLE OPTIONS MENU HELP The "Available Options" menu is the main menu for the Custom shell configuration utility. The list of options on this menu will change when you select a LAN driver. The following options may appear on this menu: --Select Resource Sets --Select LAN Driver --Configure Driver / Resources --Edit Resource List --Edit Resource Sets --Save Selections and Continue Page 1 of 2 The "Select Resource Sets" option is used to tell the shell configuration utility about extra hardware on the work station that might possibly conflict with the LAN driver's configuration. If this option needs to be done, it should be done first. The "Select LAN Driver" option allows you to select a LAN driver for the shell. The "Configure Driver / Resources" option allows you to tell the program how your hardware will be configured. This program should not allow you to select anything that would create a hardware conflict. "Edit Resource List" and "Edit Resource Sets" allow you to create and define your own resources and resource sets. Page 2 of 2 SAVE NEW RESOURCE SET DEFINITIONS? HELP If you want to save the resource set definitions you just made, highlight "Yes" and press the SELECT key. If you do not want to save the new resource set definitions, press ESCAPE or highlight "No" and press the SELECT key. Page 1 of 1 ABANDON SHELL GENERATION and EXIT! HELP The "ABANDON SHELL GENERATION and Exit!" confirmation window allows you to exit the shell generation process, or return to the shell configuration program. This window will appear under any of the following conditions: 1. Exiting the program without selecting a LAN driver. 2. Exiting the program without selecting a configuration for your LAN driver. 3. Selecting "NO" when you were asked if you wanted to "CONTINUE SHELL GENERATION USING SELECTED CONFIGURATIONS?" 4. Exiting the program with selected, but unconfigured resources. To exit the shell generation/configuration utility, highlight "Yes" and press the SELECT key. To return to the shell configuration utility, press the ESCAPE key or highlight "No" and press the SELECT key. Page 1 of 1 CONTINUE SHELL GENERATION USING SELECTED CONFIGURATIONS HELP The "Continue Shell Generation Using Selected Configurations?" confirmation box appears when all the configurations necessary for shell generation have been selected. To use the selected configurations for the shell generation, highlight "Yes" and press the SELECT key. To abandon the shell generation process, highlight "No" and press the SELECT key. To return to the shell generation program, press the ESCAPE key. Page 1 of 1 Select "Yes" to save new resource and resource set definitions. Select "No" or press ESCAPE to discard any new resource and resource set definitions. DRIVER READ ACKNOWLEDGEMENT HELP This message is displayed to confirm the driver was read correctly from the diskette. It also shows the name of the driver that was loaded. If none of this driver's available configuration options are compatible with previously selected items, then it will not appear in the list of drivers available for selection even though it was successfully loaded. Page 1 of 1 REPLACE DRIVER 1 WITH DRIVER 2? HELP The "Replace Driver 1 With Driver 2?" confirmation box indicates that the LAN driver being loaded has the same identification type number as a previously loaded LAN driver. Highlight "Yes" and press the SELECT key to replace the old driver with the new one. Highlight "No" and press the SELECT key to keep the old driver and not the new one. Page 1 of 1 BUS TYPE HELP This resource can be used with: 1. Only a (STANDARD) bus. 2. Only a (MICRO CHANNEL) bus. 3. Either type of bus. This will limit the types of resources and drivers that this resource will be compatible with. Page 1 of 1 RESOURCE SET OPTIONS HELP The "Resource Set Options" window may display one or more of the following options: SELECT LOADED ITEM This option allows you to select resource set(s) that are already loaded into the shell configuration utility. LOAD AND SELECT ITEM This option allows you to load resource set definitions from the data file "SUBSYS.SYS". This feature is intended for future resource set definition upgrades and is unnecessary for normal program usage. DESELECT AN ITEM This option allows you to remove a resource set from the list of previously selected resource sets. Page 1 of 1(# RESOURCE SET DEFINITIONS ALREADY EXIST HELP The "Resource Set Definitions Already Exist" window indicates that the defined resource sets have already been loaded into the shell generation program. This is almost always the case because that file is loaded when the program begins execution. This program function is for future resource set upgrades, and the documentation accompanying any resource upgrade should instruct you as to which option would be best to take. You have three options: DO NOT LOAD NEW RESOURCE SET DEFINITIONS This option allows you to keep the existing definitions. If you highlight this option and press the SELECT key, the "Resource Set Options" menu will reappear on the screen. Page 1 of 2 RESOURCE SET DEFINITIONS ALREADY EXIST MERGE NEW WITH EXISTING RESOURCE SET DEFINITIONS This option allows you to load new resource set definitions and merge them with the existing definitions. See the instructions below to continue. REPLACE EXISTING RESOURCE SET DEFINITIONS This option allows you to load new resource set definitions, replacing the existing definitions. See the instructions below to continue. When choosing either of these last two options, first insert a disk labeled "SHGEN-1" that has the new resource set definition file "SUBSYS.SYS" located on it. Then press the SELECT key. When the program is done reading in the file, re-insert the original "SHGEN-1" disk that was in the drive before this option was selected; then you can continue normal program execution. Page 2 of 2 CONFIGURE DRIVERS / RESOURCES HELP The "Configure Drivers / resources" menu allows you to select configurations for the hardware in the work station. The menu will list all the hardware that needs to be configured. The menu also allows you to review the configurations you have selected and to deselect any you do not want to use. However, all configurable hardware must have a configuration assigned before the shell can be generated. The following options may be displayed in the "Configure Drivers / Resources" window depending on the what driver and resource sets you selected, and on what you have already configured. --Choose Resource Configuration --Choose LAN Configuration --Review Selected Configurations --Release Resource Configuration --Release LAN Configuration Page 1 of 1 UNCONFIGURED LAN DRIVER HELP The LAN driver that you selected is displayed in the window. It needs to have a configuration selected for it. Press the SELECT key to continue. Press the ESCAPE key to return to the previous menu. Page 1 of 1 AVAILABLE LAN CONFIGURATIONS HELP The "Available LAN Configurations" window displays a list of available LAN driver configurations. One of these configurations must be selected so that the software will know how the hardware is set up. Option 0 is the recommended configuration because most boards come from the factory already set with this configuration. To select a configuration, use the UP and DOWN keys to highlight an option, then press the SELECT key. Page 1 of 1 SELECTED CONFIGURATIONS HELP The "Selected Configurations" window shows the LAN driver that you chose and its selected configuration. If you want to use this configuration, be sure that your LAN driver card is configured accordingly. Most LAN driver cards come from the factory already configured with option 0. The selected configuration information will be used to tell the shell how the LAN driver card is actually configured. The "Continue Shell Generation Using Selected Configurations?" confirmation box appears when leaving the shell generation utility after a lan driver and its configuration have been selected. To use the selected LAN driver and configuration for the shell, highlight "Yes" and press the SELECT key. When you do this, the program will automatically link and configure a shell for you. To abandon the shell generation process, highlight "No" and press the SELECT key. To return to the shell generation program, press the ESCAPE key. Page 1 of 1 UNCONFIGURED RESOURCE SETS HELP The "Unconfigured Resource Sets" window displays a list of resource sets containing at least one unconfigured resource. To view the unconfigured resources in a single resource set, use the UP and DOWN keys to highlight the resource set and press the SELECT key. Page 1 of 1 UNCONFIGURED RESOURCES HELP The "Unconfigured Resources" window displays a list of unconfigured resources in the selected resource set. Using the UP and DOWN keys, highlight the resource for which you wish to choose a configuration and press the SELECT key. Page 1 of 1 AVAILABLE RESOURCE CONFIGURATIONS HELP The "Available Resource Configurations" window displays a list of available configurations for the selected resource. Only those options that are compatible with other selected hardware are displayed. To select a configuration, use the UP and DOWN keys to highlight a single option from the list and press the SELECT key. Page 1 of 1 CONFIGURED LAN DRIVER HELP The "Configured LAN Driver" window displays the name of the LAN driver that you selected. If you want to deselect the configuration which you previously selected for this LAN, then press the SELECT key. If you do not wish to deselect this LAN's configuration, then press the ESCAPE key. Remember that your LAN must have a configuration selected for it before a valid shell can be generated. Page 1 of 1 CONFIGURED RESOURCE SETS HELP The "Configured Resource Sets" window displays a list of the resource sets for which a configuration has been selected. To view a list of configured resources in a particular resource set, highlight the resource set and press the SELECT key. Page 1 of 1 CONFIGURED RESOURCES HELP The "Configured Resources" window displays a list of resources in the selected resource set for which a configuration has been selected. Highlight the resource configuration you wish to deselect, and press the SELECT key. Selecting a resource returns it (and the resource set to which it belongs) to the "unconfigured" state. Page 1 of 1 LAN DRIVER OPTIONS HELP The "LAN Driver Options" window will display one or more of these options: SELECT LAN DRIVER FROM LIST This option allows you to choose from a list of LAN drivers that are already loaded into the shell configuration utility. You should choose a LAN driver to match your work station hardware. LOAD INTO LIST FROM LAN_DRV_.??? DISK This option allows you to load LAN drivers into the shell configuration utility from a floppy disk with a volume label matching LAN_DRV_.* and then select a driver from a list of available LAN drivers. This option is to be used to load LAN drivers that are sent out separate from the main software release. CHANGE SELECTION This option allows you to select a different LAN driver from the list of available LAN drivers. Page 1 of 1 (NEVER COMES UP / NOT USED) The maximum # of lan drivers has already been selected. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers may still be selected. LAN_TBL_FULL_HELP (NEVER COMES UP / NOT USED) No lan drivers are loaded, so none can be selected. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers may be selected. LAN_LOAD_EMPTY_HELP (NEVER COMES UP / NOT USED) There are no lan drivers which are compatible with the previously selected hardware. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers may still be selected. LAN_AVAIL_EMPTY_HELP AVAILABLE LAN DRIVERS HELP The "Available LAN Drivers" window displays a list of drivers that have been loaded into the shell generation utility. You need to select a LAN driver so a shell that can use your hardware can be generated. To select a single driver from the list, use the UP and DOWN keys to highlight a driver and press the SELECT key. Page 1 of 1 (NEVER COMES UP / NOT USED) There are no lan drivers selected, so none can be deselected. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers have been selected. LAN_TABLE_EMPTY_HELP (NOT USED) A list of selected lan drivers is displayed. The standard function keys can be used to highlight and delete a single driver from the list. Available keys are: PG_UP, PG_DN, UP, DN, SPECIAL_UP, SPECIAL_DOWN, SELECT, ESCAPE DL_HELP (NEVER USED) The maximum # of subsystems has already been selected. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers may still be selected. SYS_TAB_FULL_HELP (NEVER USED) No other drivers are loaded, so none can be selected. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers may be selected. SYS_TAB_EMPTY_HELP (NEVER USED) There are no subsystems which are compatible with the previously selected hardware. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers may still be selected. SYS_AVAIL_EMPTY_HELP AVAILABLE RESOURCE SETS HELP The "Available Resource Sets" window contains a list of the resource sets that have been loaded into the shell configuration utility. Only resource sets that will be compatible with previously selected hardware will be displayed. To select a single resource set from the list, use the UP and DOWN keys to highlight the resource set and press the SELECT key. Page 1 of 1 (NEVER USED) There are no subsystems selected, so none can be deselected. This screen shouldn't ever show up since the menu option will only be displayed if one or more drivers have been selected. SYS_SEL_EMPTY_HELP RESOURCE SET OPTIONS DESELECT AN ITEM HELP The "Selected Resource Sets" window displays a list of the resource sets you selected. To remove a selected resource set from this list, use the UP an DOWN keys to highlight the resource set and press the SELECT key. Page 1 of 1 RESOURCE SETS HELP A list of all the defined resource sets is displayed. The user can add, delete, or modify resource set names, or edit the list of resources associated with a resource set. The following keys are available: SELECT Display/Edit the list of resources which compose this resource set. DELETE Delete the marked resource set definition(s). INSERT Define a new resource set name. The resource set initially has no resources in its list. MODIFY Edit a resource set name. MARK Mark 1 or more resource sets for deletion. Toggles marking. UNMARK Unmark all resource sets. Additional Keys (for moving through the list): PG_UP, PG_DN, UP, DOWN, SPECIAL_UP, SPECIAL_DOWN. Page 1 of 1 DELETE MARKED RESOURCE SET? HELP The "Delete Marked Resource Set?" confirmation box allows you to delete all marked resource sets. To delete the marked resource sets from the "Resource Sets" list, highlight "Yes" and press the SELECT key. If you do not wish to change the "Resource Sets" list, highlight "No" and press the SELECT key. Page 1 of 1 RESOURCE SET NAME HELP The "Resource Set Name" entry box allows you to add the name of a new resource set to the "Resource Sets" list. This name must be unique. The new resource set will be added to the list, but will contain no resources. To add a new resource set, type the name of the resource set and press the SELECT key. Press the ESCAPE key to leave the list of resource sets unchanged. Page 1 of 1 RESOURCE SET NAME HELP The "Resource Set Name" entry box allows you to modify the name of the selected resource set. The new name of the selected resource set must be different than the old one and from all other defined resource sets. Use the arrow keys and the BACKSPACE key to edit the resource set name and then press the SELECT key. Press the ESCAPE key to leave the list of resource sets unchanged. Page 1 of 1 DUPLICATE RESOURCE SET ERROR HELP This error message indicates that a resource set name was entered that duplicates the name of an existing resource set in the "Resource Sets" list. To continue, press the ESCAPE key. Page 1 of 1 SELECTED RESOURCES HELP The "Selected Resources" window displays a list of resources that compose the selected resource set. You may add or remove resources from the set. To add a previously defined resource to the set, press the INSERT key for a list of available resources. To remove a resource from the set, highlight that resource and press the DELETE key. Page 1 of 1 DELETE MARKED RESOURCE HELP The "Delete Marked Resource" confirmation box allows you to remove all marked resources from the selected resource set. To remove marked resource(s), highlight "Yes" and press the SELECT key. To leave the resource set unchanged, highlight "No" and press the SELECT key. Page 1 of 1 RESOURCE SET NUMBER ERROR HELP This error indicates that the maximum number of resources has been chosen for the selected resource set. Before selecting additional resources, one or more of the currently selected resources must be removed from the resource set definition. To continue, press the ESCAPE key. Page 1 of 1 No cards can be selected for the subsystem since none are defined. CARD_EMPTY_HELP None of the defined cards are compatible with the set of cards already selected for this subsystem. There would be no way to configure the hardware so that other cards could co-exist with the already selected cards. CARD_AVAIL_EMPTY_HELP AVAILABLE RESOURCES HELP The "Available Resources" window displays a list of defined resources. Only resources that are compatible with the previously selected resource are displayed. To add a resource to the "Selected Resources" list, highlight the resource and press the SELECT key. Page 1 of 1 RESOURCES HELP A list of all the defined resources is displayed. The user may add, delete, modify resource names, or edit the list of configurations associated with a resource. The following keys are available: SELECT Display/Edit the configurations defined for this resource. DELETE Delete the marked resource definition(s). INSERT Define a new resource name. The resource initially has no configurations. MODIFY Rename a resource. MARK Mark 1 or more resources for deletion. Toggles marking. UNMARK Unmark all resources. Additional Keys (for moving through the list): PG_UP, PG_DN, UP, DOWN, SPECIAL_UP, SPECIAL_DOWN. Page 1 of 1 DELETE MARKED RESOURCE HELP The "Delete Marked Resource?" confirmation box allows you to delete the resource(s) marked in the "Resources" window. To delete the marked resource, highlight "Yes" and press the SELECT key. To leave the list of resources unchanged, highlight "No" and press the select key. Page 1 of 1 RESOURCE NAME HELP The "Resource Name" entry box allows you to add a new resource to the "Resources" window. Type the name of the new resource and press the SELECT key. To leave the resource list unchanged, press the ESCAPE key. Page 1 of 1 RESOURCE NAME HELP The "Resource Name" entry box allows you to modify the name of an existing resource. Type the new name of the resource and press the SELECT key. To leave the resource list unchanged, press the ESCAPE key. Page 1 of 1 DUPLICATE RESOURCE NAME ERROR HELP This error message appears when you attempt to enter a resource name that is a duplicate of a resource that is already defined. All resources must have unique names to be valid. To continue, press the ESCAPE key. Page 1 of 1 RESOURCE CONFIGURATIONS HELP A list of all the configurations defined for this resource is displayed. The user can add, delete, or modify configuration names, or edit the definition of a particular configuration. The following keys are available: SELECT Display/Edit the configuration. DELETE Delete the marked configuration definition(s). INSERT Define a new configuration name. The configuration name initially has no hardware usage definition. MODIFY Rename a configuration. MARK Mark 1 or more configurations for deletion. Toggles marking. UNMARK Unmark all configurations. Additional Keys (for moving through the list): PG_UP, PG_DN, UP, DOWN, SPECIAL_UP, SPECIAL_DOWN. Page 1 of 1 DELETE MARKED RESOURCE CONFIGURATION? HELP Highlight "Yes" and press the SELECT key to delete the marked configuration definition(s). To leave the "Resource Configurations" list unchanged, highlight "No" and press the SELECT key. Page 1 of 1 RESOURCE CONFIGURATION NAME HELP The "Resource Configuration Name" entry box allows you to add a new resource configuration name. By convention, such names should start with a one- or a two-digit, space-padded number followed by a colon and a space. For example: 0: Configuration 0 - IRQ 7, DMA 3... 10: Configuration 10 - IRQ 5, DMA 2... This allows the user to impose an ordering on the configuration list that is not related to the alphabetic order of the configuration names. Type the name of the new resource configuration and press the SELECT key. To leave the list of configurations unchanged, press the ESCAPE key. Page 1 of 1 RESOURCE CONFIGURATION NAME HELP The "Resource Configuration Name" window allows you to modify the name of the selected resource configuration. By convention, such names should start with a one- or a two-digit, space-padded number followed by a colon and a space. For example: 0: Configuration 0 - IRQ 7, DMA 3... 10: Configuration 10 - IRQ 5, DMA 2... This allows the user to impose an ordering on the configuration list that is not related to the alphabetic order of the configuration name. Use the RIGHT, LEFT, and BACKSPACE keys to help in editing the configuration name; then press the SELECT key. To leave the list of configurations unchanged, press the ESCAPE key. Page 1 of 1 DUPLICATE RESOURCE CONFIGURATION NAME ERROR HELP This error message appears when you add a resource configuration name that duplicates one already in the "Resource Configurations" list. To continue, press the ESCAPE key. Page 1 of 1 CONFIGURATION INFORMATION HELP The "Configuration Information" window allows you to define a specific configuration (hardware usage) for the selected resource. As many as two I/O and memory ranges, interrupt lines and DMA channels may be set for each resource. Press the F2 key to switch between hex and decimal editing modes. Use the UP, DOWN, LEFT, and RIGHT keys to move to the item you wish to specify and press the SELECT key. Edit the field using the arrow, DELETE, and BACKSPACE keys. Press the SELECT key to save changes to the field. Page 1 of 3 The "Bus Type" refers to the type of hardware bus this resource is designed to be used with - "Standard" bus indicates that the resource is only compatible with other resources that use a standard bus, "Micro Channel" bus indicates that the resource is only compatible with other resources that use a micro channel bus, and "Either Type" indicates that the resource is compatible with resources that use either type of bus. The I/O port range is the number of contiguous ports decoded by that resource. The memory range is the number of paragraphs decoded by the resource. The interrupt lines are defined if the hardware configuration uses interrupts. Likewise, DMA lines are defined only if the configuration uses them. Page 2 of 3 This information is used by the program when comparing configurations to decide if they are compatible. Compatible configurations cannot have overlapping I\O or memory ranges. They cannot use the same INT or DMA lines. And they must have compatible bus types. Page 3 of 3 (CURRENTLY NOT USED BY FORM LIBRARY ROUTINES) This help screen is in force when the user has made changes to one of the fields on the Configuration Information form, and then presses ESCAPE. The menu has 3 options: Save and Exit -- the field contents are changed, and the user is returned to field selection mode. Cancel and Exit -- the field contents are returned to their original state, and the user is returned to field selection mode. Do Not Exit -- The user returns to editing the field contents. ECON_FIELD_HELP EXCESS VALUE ERROR HELP This error message indicates that the value entered for this item was either less than zero, or greater than the limit defined for this field. As many as two I/O and memory address ranges, interrupt lines, and DMA channels may be specified for the selected configuration. Press the ESCAPE key to continue. Page 1 of 1 SELECTED CONFIGURATIONS HELP The screen being displayed shows what hardware you have selected and how it should be configured. The user should write down the contents of this screen for later reference when he configures his hardware. Page 1 of 1